home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1992 June: ROMin Holiday / ADC Developer CD (1992-06) (''ROMin Holiday'')_iso / Developer Connection - 06-1992.iso / Developer Essentials / MPW Interfaces & Libraries / PInterfaces / AppleEvents.p < prev    next >
Encoding:
Text File  |  1992-01-29  |  22.8 KB  |  600 lines  |  [TEXT/MPS ]
  1.  
  2. {
  3. Created: Monday, September 16, 1991 at 2:41 PM
  4.  AppleEvents.p
  5.  Pascal Interface to the Macintosh Libraries
  6.  
  7.   Copyright Apple Computer, Inc. 1989-1991
  8.   All rights reserved
  9.  
  10. }
  11.  
  12.  
  13. {$IFC UNDEFINED UsingIncludes}
  14. {$SETC UsingIncludes := 0}
  15. {$ENDC}
  16.  
  17. {$IFC NOT UsingIncludes}
  18.  UNIT AppleEvents;
  19.  INTERFACE
  20. {$ENDC}
  21.  
  22. {$IFC UNDEFINED UsingAppleEvents}
  23. {$SETC UsingAppleEvents := 1}
  24.  
  25. {$I+}
  26. {$SETC AppleEventsIncludes := UsingIncludes}
  27. {$SETC UsingIncludes := 1}
  28. {$IFC UNDEFINED UsingTypes}
  29. {$I $$Shell(PInterfaces)Types.p}
  30. {$ENDC}
  31. {$IFC UNDEFINED UsingMemory}
  32. {$I $$Shell(PInterfaces)Memory.p}
  33. {$ENDC}
  34. {$IFC UNDEFINED UsingOSUtils}
  35. {$I $$Shell(PInterfaces)OSUtils.p}
  36. {$ENDC}
  37. {$IFC UNDEFINED UsingEvents}
  38. {$I $$Shell(PInterfaces)Events.p}
  39. {$ENDC}
  40. {$IFC UNDEFINED UsingEPPC}
  41. {$I $$Shell(PInterfaces)EPPC.p}
  42. {$ENDC}
  43. {$IFC UNDEFINED UsingNotification}
  44. {$I $$Shell(PInterfaces)Notification.p}
  45. {$ENDC}
  46. {$SETC UsingIncludes := AppleEventsIncludes}
  47.  
  48. CONST
  49. typeBoolean = 'bool';
  50. typeChar = 'TEXT';
  51. typeSMInt = 'shor';
  52. typeInteger = 'long';
  53. typeSMFloat = 'sing';
  54. typeFloat = 'doub';
  55. typeLongInteger = 'long';
  56. typeShortInteger = 'shor';
  57. typeLongFloat = 'doub';
  58. typeShortFloat = 'sing';
  59. typeExtended = 'exte';
  60. typeComp = 'comp';
  61. typeMagnitude = 'magn';
  62. typeAEList = 'list';
  63. typeAERecord = 'reco';
  64. typeTrue = 'true';
  65. typeFalse = 'fals';
  66. typeAlias = 'alis';
  67. typeEnumerated = 'enum';
  68. typeType = 'type';
  69. typeAppParameters = 'appa';
  70. typeProperty = 'prop';
  71. typeFSS = 'fss ';
  72. typeKeyword = 'keyw';
  73. typeSectionH = 'sect';
  74. typeWildCard = '****';
  75.  
  76. typeApplSignature = 'sign';
  77. typeSessionID = 'ssid';
  78. typeTargetID = 'targ';
  79. typeProcessSerialNumber = 'psn ';
  80. typeNull = 'null';                    {the type of null/nonexistent data}
  81.  
  82. kCoreEventClass = 'aevt';
  83.  
  84. kAEOpenApplication = 'oapp';
  85. kAEOpenDocuments = 'odoc';
  86. kAEPrintDocuments = 'pdoc';
  87. kAEQuitApplication = 'quit';
  88.  
  89. kAECreatorType = 'crea';
  90. kAEQuitAll = 'quia';
  91. kAEShutDown = 'shut';
  92. kAERestart = 'rest';
  93. kAEApplicationDied = 'obit';
  94. keyProcessSerialNumber = 'psn ';
  95.  
  96. keyErrorNumber = 'errn';
  97. keyErrorString = 'errs';
  98.  
  99. kAEAnswer = 'ansr';
  100.  
  101. keyDirectObject = '----';
  102.  
  103.  
  104. { keyword used in install special handler }
  105. keyPreDispatch = 'phac';            { PreHandler Accessor Call }
  106. keySelectProc = 'selh';                { More selector Call }
  107.  
  108. { keywords used in attributes }
  109. keyTransactionIDAttr = 'tran';
  110. keyReturnIDAttr = 'rtid';
  111. keyEventClassAttr = 'evcl';
  112. keyEventIDAttr = 'evid';
  113. keyAddressAttr = 'addr';
  114. keyOptionalKeywordAttr = 'optk';
  115. keyTimeoutAttr = 'timo';
  116. keyInteractLevelAttr = 'inte';        {this attribute is read only will be set in AESend}
  117. keyEventSourceAttr = 'esrc';        { this attribute is read only }
  118. keyMissedKeywordAttr = 'miss';        { this attribute is read only }
  119.  
  120. { constants for use in AESendMode }
  121. kAENoReply = $00000001;                { Sender doesn't want a reply to event }
  122. kAEQueueReply = $00000002;            { Sender wants a reply but won't wait }
  123. kAEWaitReply = $00000003;            { Sender wants a reply and will be waiting }
  124.  
  125. kAENeverInteract = $00000010;        { Server should not interact with user }
  126. kAECanInteract = $00000020;            { Server may try to interact with user }
  127. kAEAlwaysInteract = $00000030;        { Server should always interact with user where appropriate }
  128.  
  129. kAECanSwitchLayer = $00000040;        { Interaction may switch layer }
  130.  
  131. kAEDontReconnect = $00000080;        { don't reconnect if there is a sessClosedErr from PPCToolbox }
  132.  
  133. kAEWantReceipt = nReturnReceipt;    { Send wants a receipt of message }
  134.  
  135. { constants to be used in AESendPriority }
  136. kAENormalPriority = $00000000;        { Post message at the end of event queue }
  137. kAEHighPriority = nAttnMsg;            { Post message at the front of the event queue }
  138.  
  139. { special constants in generating events }
  140. kAnyTransactionID = 0;                { no transaction is in use }
  141. kAutoGenerateReturnID = -1;            { AECreateAppleEvent will generate a session-unique ID }
  142.  
  143. { constant for use AESend }
  144. kAEDefaultTimeout = -1;                { timeout value determined by AEM }
  145. kNoTimeOut = -2;                    { wait until reply comes back, however long it takes }
  146.  
  147. { dispatch parameter to AEResumeTheCurrentEvent takes a pointer to a dispatch
  148. table, or one of these two constants }
  149. kAENoDispatch = 0;
  150. kAEUseStandardDispatch = -1;
  151.  
  152. { Error messages in response to reading and writing event contents }
  153. errAECoercionFail = -1700;
  154. errAEDescNotFound = -1701;
  155. errAECorruptData = -1702;
  156. errAEWrongDataType = -1703;
  157. errAENotAEDesc = -1704;
  158. errAEBadListItem = -1705;            { Specified list item does not exist }
  159. errAENewerVersion = -1706;            { Need newer version of AppleEvent Manager }
  160. errAENotAppleEvent = -1707;            { The event is not in AppleEvent format }
  161.  
  162. { Error messages in response to sending/receiving a message }
  163. errAEEventNotHandled = -1708;        { The AppleEvent was not handled by any handler }
  164. errAEReplyNotValid = -1709;            { AEResetTimer was passed an invalid reply parameter }
  165. errAEUnknownSendMode = -1710;        { Mode wasn't NoReply, WaitReply, or QueueReply;  or Interaction level is unknown }
  166. errAEWaitCanceled = -1711;            { In AESend, User cancelled out of wait loop for  reply or receipt }
  167. errAETimeout = -1712;                { AppleEvent timed out }
  168.  
  169. errAENoUserInteraction = -1713;        { no user interaction allowed }
  170. errAENotASpecialFunction = -1714;    { there is no special function with this keyword }
  171. errAEParamMissed = -1715;            { a required parameter was not accessed }
  172.  
  173. errAEUnknownAddressType = -1716;    { The target address type is not known }
  174. errAEHandlerNotFound = -1717;        { No handler in the dispatch tables fits the parameters to
  175.              AEGetEventHandler or AEGetCoercionHandler }
  176.  
  177. errAEReplyNotArrived = -1718;        { the contents of the reply you are accessing have not arrived yet }
  178. errAEIllegalIndex = -1719;            { Index is out of range in a put operation }
  179.  
  180. TYPE
  181. AEKeyword    = PACKED ARRAY [1..4] OF CHAR;
  182. AEEventClass  = PACKED ARRAY [1..4] OF CHAR;
  183. AEEventID    = PACKED ARRAY [1..4] OF CHAR;
  184. DescType = ResType;
  185.  
  186. { tagged data, the standard AppleEvent data type }
  187. AEDesc = RECORD
  188.  descriptorType: DescType;
  189.  dataHandle: Handle;
  190.  END;
  191.  
  192.  
  193. AEAddressDesc = AEDesc;                { an AEDesc which contains addressing data }
  194. AEDescList = AEDesc;                { a list of AEDesc is a special kind of AEDesc }
  195. AERecord = AEDescList;                { AERecord is a list of keyworded AEDesc }
  196. AppleEvent = AERecord;                { an AERecord that contains an AppleEvent }
  197. AESendMode = LONGINT;                { Type of parameter to AESend }
  198. AESendPriority = INTEGER;            { Type of priority param of AESend }
  199.  
  200. { type of param to AEGetInteractionAllowed and AESetInteractionAllowed }
  201. AEInteractAllowed = (kAEInteractWithSelf,kAEInteractWithLocal,kAEInteractWithAll);
  202.  
  203. { Return param to AEGetTheCurrentEvent, and kAEEventSource attribute }
  204. AEEventSource = (kAEUnknownSource,kAEDirectCall,kAESameProcess,kAELocalProcess,
  205.  kAERemoteProcess);
  206.  
  207.  
  208. { types for AppleEvent Array support 
  209.  
  210.  Basic data type of attibutes & parameters}
  211. AEKeyDesc = RECORD
  212.  descKey: AEKeyword;
  213.  descContent: AEDesc;
  214.  END;
  215.  
  216.  
  217. AEArrayType = (kAEDataArray,kAEPackedArray,kAEHandleArray,kAEDescArray,
  218.  kAEKeyDescArray);
  219.  
  220.  
  221. { Array routines support these different types of elements}
  222. AEArrayData = RECORD
  223.  case AEArrayType OF
  224.   kAEDataArray: 
  225.    (AEDataArray:   Array[0..0] OF Integer);
  226.   kAEPackedArray: 
  227.    (AEPackedArray:  Packed Array[0..0] OF Char);
  228.   kAEHandleArray: 
  229.    (AEHandleArray:  Array[0..0] OF Handle);
  230.   kAEDescArray: 
  231.    (AEDescArray:   Array[0..0] OF AEDesc);
  232.   kAEKeyDescArray: 
  233.    (AEKeyDescArray:  Array[0..0] OF AEKeyDesc);
  234.  END;
  235.  
  236. AEArrayDataPointer = ^AEArrayData;
  237.  
  238.  
  239.  
  240. EventHandlerProcPtr = ProcPtr;
  241. IdleProcPtr = ProcPtr;
  242. EventFilterProcPtr = ProcPtr;
  243.  
  244.  
  245. {   *********************************************************************
  246. The following calls apply to any AEDesc. Every result descriptor is created for you,
  247. so you will be responsible for memory management of the descriptors so created.
  248. Purgeable descriptor data is not supported: the AEM does not call LoadResource.   }
  249. FUNCTION AECreateDesc(typeCode: DescType;
  250.                       dataPtr: Ptr;
  251.                       dataSize: Size;
  252.                       VAR result: AEDesc): OSErr;
  253.  INLINE $303C, $0825, $A816;
  254. FUNCTION AECoercePtr(typeCode: DescType;
  255.                      dataPtr: Ptr;
  256.                      dataSize: Size;
  257.                      toType: DescType;
  258.                      VAR result: AEDesc): OSErr;
  259.  INLINE $303C, $0A02, $A816;
  260. FUNCTION AECoerceDesc(theAEDesc: AEDesc;
  261.                       toType: DescType;
  262.                       VAR result: AEDesc): OSErr;
  263.  INLINE $303C, $0603, $A816;
  264. FUNCTION AEDisposeDesc(VAR theAEDesc: AEDesc): OSErr;
  265.  INLINE $303C, $0204, $A816;
  266. FUNCTION AEDuplicateDesc(theAEDesc: AEDesc;
  267.                          VAR result: AEDesc): OSErr;
  268.  INLINE $303C, $0405, $A816;
  269.  
  270. { *********************************************************************
  271.  The following calls apply to AEDescList.
  272.   Since AEDescList is a subtype of AEDesc, the calls in the previous
  273.   section can also be used for AEDescList. All list and array indices are 1-based.
  274.   If the data was greater than maximumSize in the routines below, then actualSize will
  275.   be greater than maximumSize, but only maximumSize bytes will actually be retrieved. }
  276. FUNCTION AECreateList(factoringPtr: Ptr;
  277.                       factoredSize: Size;
  278.                       isRecord: BOOLEAN;
  279.                       VAR resultList: AEDescList): OSErr;
  280.  INLINE $303C, $0706, $A816;
  281. FUNCTION AECountItems(theAEDescList: AEDescList;
  282.                       VAR theCount: LONGINT): OSErr;
  283.  INLINE $303C, $0407, $A816;
  284. FUNCTION AEPutPtr(theAEDescList: AEDescList;
  285.                   index: LONGINT;
  286.                   typeCode: DescType;
  287.                   dataPtr: Ptr;
  288.                   dataSize: Size): OSErr;
  289.  INLINE $303C, $0A08, $A816;
  290. FUNCTION AEPutDesc(theAEDescList: AEDescList;
  291.                    index: LONGINT;
  292.                    theAEDesc: AEDesc): OSErr;
  293.  INLINE $303C, $0609, $A816;
  294. FUNCTION AEGetNthPtr(theAEDescList: AEDescList;
  295.                      index: LONGINT;
  296.                      desiredType: DescType;
  297.                      VAR theAEKeyword: AEKeyword;
  298.                      VAR typeCode: DescType;
  299.                      dataPtr: Ptr;
  300.                      maximumSize: Size;
  301.                      VAR actualSize: Size): OSErr;
  302.  INLINE $303C, $100A, $A816;
  303. FUNCTION AEGetNthDesc(theAEDescList: AEDescList;
  304.                       index: LONGINT;
  305.                       desiredType: DescType;
  306.                       VAR theAEKeyword: AEKeyword;
  307.                       VAR result: AEDesc): OSErr;
  308.  INLINE $303C, $0A0B, $A816;
  309. FUNCTION AESizeOfNthItem(theAEDescList: AEDescList;
  310.                          index: LONGINT;
  311.                          VAR typeCode: DescType;
  312.                          VAR dataSize: Size): OSErr;
  313.  INLINE $303C, $082A, $A816;
  314. FUNCTION AEGetArray(theAEDescList: AEDescList;
  315.                     arrayType: AEArrayType;
  316.                     arrayPtr: AEArrayDataPointer;
  317.                     maximumSize: Size;
  318.                     VAR itemType: DescType;
  319.                     VAR itemSize: Size;
  320.                     VAR itemCount: LONGINT): OSErr;
  321.  INLINE $303C, $0D0C, $A816;
  322. FUNCTION AEPutArray(theAEDescList: AEDescList;
  323.                     arrayType: AEArrayType;
  324.                     arrayPtr: AEArrayDataPointer;
  325.                     itemType: DescType;
  326.                     itemSize: Size;
  327.                     itemCount: LONGINT): OSErr;
  328.  INLINE $303C, $0B0D, $A816;
  329. FUNCTION AEDeleteItem(theAEDescList: AEDescList;
  330.                       index: LONGINT): OSErr;
  331.  INLINE $303C, $040E, $A816;
  332.  
  333. { *********************************************************************
  334. The following calls apply to AERecord.
  335.   Since AERecord is a subtype of AEDescList, the calls in the previous
  336.   sections can also be used for AERecord
  337.   an AERecord can be created by using AECreateList with isRecord set to true  }
  338. FUNCTION AEPutKeyPtr(theAERecord: AERecord;
  339.                      theAEKeyword: AEKeyword;
  340.                      typeCode: DescType;
  341.                      dataPtr: Ptr;
  342.                      dataSize: Size): OSErr;
  343.  INLINE $303C, $0A0F, $A816;
  344. FUNCTION AEPutKeyDesc(theAERecord: AERecord;
  345.                       theAEKeyword: AEKeyword;
  346.                       theAEDesc: AEDesc): OSErr;
  347.  INLINE $303C, $0610, $A816;
  348. FUNCTION AEGetKeyPtr(theAERecord: AERecord;
  349.                      theAEKeyword: AEKeyword;
  350.                      desiredType: DescType;
  351.                      VAR typeCode: DescType;
  352.                      dataPtr: Ptr;
  353.                      maximumSize: Size;
  354.                      VAR actualSize: Size): OSErr;
  355.  INLINE $303C, $0E11, $A816;
  356. FUNCTION AEGetKeyDesc(theAERecord: AERecord;
  357.                       theAEKeyword: AEKeyword;
  358.                       desiredType: DescType;
  359.                       VAR result: AEDesc): OSErr;
  360.  INLINE $303C, $0812, $A816;
  361. FUNCTION AESizeOfKeyDesc(theAERecord: AERecord;
  362.                          theAEKeyword: AEKeyword;
  363.                          VAR typeCode: DescType;
  364.                          VAR dataSize: Size): OSErr;
  365.  INLINE $303C, $0829, $A816;
  366. FUNCTION AEDeleteKeyDesc(theAERecord: AERecord;
  367.                          theAEKeyword: AEKeyword): OSErr;
  368.  INLINE $303C, $0413, $A816;
  369.  
  370. { 
  371.  *********************************************************************
  372.  The following calls are used to pack and unpack parameters from records of
  373.  type AppleEvent. Since AppleEvent is a subtype of AERecord, the calls in the previous
  374.  sections can also be used for variables of type AppleEvent. The next six calls
  375.  are in fact identical to the six calls for AERecord.
  376.  }
  377. FUNCTION AEPutParamPtr(theAppleEvent: AppleEvent;
  378.                        theAEKeyword: AEKeyword;
  379.                        typeCode: DescType;
  380.                        dataPtr: Ptr;
  381.                        dataSize: Size): OSErr;
  382.  INLINE $303C,$0A0F,$A816;
  383. FUNCTION AEPutParamDesc(theAppleEvent: AppleEvent;
  384.                         theAEKeyword: AEKeyword;
  385.                         theAEDesc: AEDesc): OSErr;
  386.  INLINE $303C,$0610,$A816;
  387. FUNCTION AEGetParamPtr(theAppleEvent: AppleEvent;
  388.                        theAEKeyword: AEKeyword;
  389.                        desiredType: DescType;
  390.                        VAR typeCode: DescType;
  391.                        dataPtr: Ptr;
  392.                        maximumSize: Size;
  393.                        VAR actualSize: Size): OSErr;
  394.  INLINE $303C,$0E11,$A816;
  395. FUNCTION AEGetParamDesc(theAppleEvent: AppleEvent;
  396.                         theAEKeyword: AEKeyword;
  397.                         desiredType: DescType;
  398.                         VAR result: AEDesc): OSErr;
  399.  INLINE $303C,$0812,$A816;
  400. FUNCTION AESizeOfParam(theAppleEvent: AppleEvent;
  401.                        theAEKeyword: AEKeyword;
  402.                        VAR typeCode: DescType;
  403.                        VAR dataSize: Size): OSErr;
  404.  INLINE $303C,$0829,$A816;
  405. FUNCTION AEDeleteParam(theAppleEvent: AppleEvent;
  406.                        theAEKeyword: AEKeyword): OSErr;
  407.  INLINE $303C,$0413,$A816;
  408.  
  409. { *********************************************************************
  410. The following calls also apply to type AppleEvent.  Message attributes are far more restricted, and
  411. can only be accessed through the following 5 calls. The various list and record routines cannot be used
  412. to access the attributes of an event.  }
  413. FUNCTION AEGetAttributePtr(theAppleEvent: AppleEvent;
  414.                            theAEKeyword: AEKeyword;
  415.                            desiredType: DescType;
  416.                            VAR typeCode: DescType;
  417.                            dataPtr: Ptr;
  418.                            maximumSize: Size;
  419.                            VAR actualSize: Size): OSErr;
  420.  INLINE $303C,$0E15,$A816;
  421. FUNCTION AEGetAttributeDesc(theAppleEvent: AppleEvent;
  422.                             theAEKeyword: AEKeyword;
  423.                             desiredType: DescType;
  424.                             VAR result: AEDesc): OSErr;
  425.  INLINE $303C,$0826,$A816;
  426. FUNCTION AESizeOfAttribute(theAppleEvent: AppleEvent;
  427.                            theAEKeyword: AEKeyword;
  428.                            VAR typeCode: DescType;
  429.                            VAR dataSize: Size): OSErr;
  430.  INLINE $303C,$0828,$A816;
  431. FUNCTION AEPutAttributePtr(theAppleEvent: AppleEvent;
  432.                            theAEKeyword: AEKeyword;
  433.                            typeCode: DescType;
  434.                            dataPtr: Ptr;
  435.                            dataSize: Size): OSErr;
  436.  INLINE $303C,$0A16,$A816;
  437. FUNCTION AEPutAttributeDesc(theAppleEvent: AppleEvent;
  438.                             theAEKeyword: AEKeyword;
  439.                             theAEDesc: AEDesc): OSErr;
  440.  INLINE $303C,$0627,$A816;
  441.  
  442. { *********************************************************************
  443.  The next four calls are basic routines used to create, send, and process AppleEvents.  }
  444. FUNCTION AECreateAppleEvent(theAEEventClass: AEEventClass;
  445.                             theAEEventID: AEEventID;
  446.                             target: AEAddressDesc;
  447.                             returnID: INTEGER;
  448.                             transactionID: LONGINT;
  449.                             VAR result: AppleEvent): OSErr;
  450.  INLINE $303C,$0B14,$A816;
  451. FUNCTION AESend(theAppleEvent: AppleEvent;
  452.                 VAR reply: AppleEvent;
  453.                 sendMode: AESendMode;
  454.                 sendPriority: AESendPriority;
  455.                 timeOutInTicks: LONGINT;
  456.                 idleProc: IdleProcPtr;
  457.                 filterProc: EventFilterProcPtr): OSErr;
  458.  INLINE $303C,$0D17,$A816;
  459. FUNCTION AEProcessAppleEvent(theEventRecord: EventRecord): OSErr;
  460.  INLINE $303C,$021B,$A816;
  461.  
  462. { During event processing, an event handler may realize that it is likely
  463. to exceed the client's timeout limit. Passing the reply to this
  464. routine causes a wait event to be generated to ask the client for more time.  }
  465. FUNCTION AEResetTimer(reply: AppleEvent): OSErr;
  466.  INLINE $303C,$0219,$A816;
  467.  
  468. {   *********************************************************************
  469. The following four calls are available for applications which need more sophisticated control
  470. over when and how events are processed. Applications which implement multi-session servers or 
  471. which implement their own internal event queueing will probably be the major clients of these
  472. routines.  
  473.  
  474.  Can be called from within a handler to prevent the AEM from disposing of
  475. the AppleEvent when the handler returns. Can be used to asynchronously process the 
  476. event (as in MacApp). }
  477. FUNCTION AESuspendTheCurrentEvent(theAppleEvent: AppleEvent): OSErr;
  478.  INLINE $303C,$022B,$A816;
  479.  
  480. { 
  481.   Tells the AppleEvent manager that processing is either about to resume or has
  482.  been completed on a previously suspended event. The procPtr passed in as the
  483.  dispatcher parameter will be called to attempt to redispatch the event. Several
  484.  constants for the dispatcher parameter allow special behavior. They are:
  485.  - kAEUseStandardDispatch means redispatch as if the event was just received, using the
  486.   standard AppleEvent Dispatcher.
  487.  - kAENoDispatch means ignore the parameter.
  488.   Use this in the case where no redispatch is needed, and the event has been handled.
  489.  - non nil means call the routine which dispatcher points to.
  490.  }
  491. FUNCTION AEResumeTheCurrentEvent(theAppleEvent: AppleEvent;
  492.                                  reply: AppleEvent;
  493.                                  dispatcher: EventHandlerProcPtr;
  494.                                  handlerRefcon: LONGINT): OSErr;
  495.  INLINE $303C,$0818,$A816;
  496.  
  497. { Allows application to examine the currently executing event }
  498. FUNCTION AEGetTheCurrentEvent(VAR theAppleEvent: AppleEvent): OSErr;
  499.  INLINE $303C,$021A,$A816;
  500.  
  501. { Set the current event to the parameter }
  502. FUNCTION AESetTheCurrentEvent(theAppleEvent: AppleEvent): OSErr;
  503.  INLINE $303C,$022C,$A816;
  504.  
  505. { 
  506.  *********************************************************************
  507.   The following three calls are used to allow applications to behave courteously 
  508.  when a user interaction such as a dialog box is needed. 
  509.  }
  510. FUNCTION AEGetInteractionAllowed(VAR level: AEInteractAllowed): OSErr;
  511.  INLINE $303C,$021D,$A816;
  512. FUNCTION AESetInteractionAllowed(level: AEInteractAllowed): OSErr;
  513.  INLINE $303C,$011E,$A816;
  514. FUNCTION AEInteractWithUser(timeOutInTicks: LONGINT;
  515.                             nmReqPtr: NMRecPtr;
  516.                             idleProc: IdleProcPtr): OSErr;
  517.  INLINE $303C,$061C,$A816;
  518.  
  519. {  *********************************************************************
  520.  These calls are used to set up and modify the event dispatch table  }
  521.  
  522. { Add an AppleEvent Handler  }
  523. FUNCTION AEInstallEventHandler(theAEEventClass: AEEventClass;
  524.                                theAEEventID: AEEventID;
  525.                                handler: EventHandlerProcPtr;
  526.                                handlerRefcon: LONGINT;
  527.                                isSysHandler: BOOLEAN): OSErr;
  528.  INLINE $303C,$091F,$A816;
  529.  
  530. {  Remove an AppleEvent Handler  }
  531. FUNCTION AERemoveEventHandler(theAEEventClass: AEEventClass;
  532.                               theAEEventID: AEEventID;
  533.                               handler: EventHandlerProcPtr;
  534.                               isSysHandler: BOOLEAN): OSErr;
  535.  INLINE $303C,$0720,$A816;
  536.  
  537. {  Get the corresponding AppleEvent Handler  }
  538. FUNCTION AEGetEventHandler(theAEEventClass: AEEventClass;
  539.                            theAEEventID: AEEventID;
  540.                            VAR handler: EventHandlerProcPtr;
  541.                            VAR handlerRefcon: LONGINT;
  542.                            isSysHandler: BOOLEAN): OSErr;
  543.  INLINE $303C,$0921,$A816;
  544.  
  545. {  *********************************************************************
  546.  These calls are used to set up and modify the coercion dispatch table   }
  547. FUNCTION AEInstallCoercionHandler(fromType: DescType;
  548.                                   toType: DescType;
  549.                                   handler: ProcPtr;
  550.                                   handlerRefcon: LONGINT;
  551.                                   fromTypeIsDesc: BOOLEAN;
  552.                                   isSysHandler: BOOLEAN): OSErr;
  553.  INLINE $303C, $0A22, $A816;
  554.  
  555. {  Remove a Coercion Handler  }
  556. FUNCTION AERemoveCoercionHandler(fromType: DescType;
  557.                                  toType: DescType;
  558.                                  handler: ProcPtr;
  559.                                  isSysHandler: BOOLEAN): OSErr;
  560.  INLINE $303C, $0723, $A816;
  561.  
  562. {  Get the corresponding Coercion Handler  }
  563. FUNCTION AEGetCoercionHandler(fromType: DescType;
  564.                               toType: DescType;
  565.                               VAR handler: ProcPtr;
  566.                               VAR handlerRefcon: LONGINT;
  567.                               VAR fromTypeIsDesc: BOOLEAN;
  568.                               isSysHandler: BOOLEAN): OSErr;
  569.  INLINE $303C, $0B24, $A816;
  570.  
  571. { 
  572.    *********************************************************************
  573.  These calls are used to set up and modify special hooks into the AppleEvent Manager.
  574.  
  575.  Install the special handler named by the Keyword   }
  576. FUNCTION AEInstallSpecialHandler(functionClass: AEKeyword;
  577.                                  handler: ProcPtr;
  578.                                  isSysHandler: BOOLEAN): OSErr;
  579.  INLINE $303C, $0500, $A816;
  580.  
  581. {  Remove the special handler named by the Keyword  }
  582. FUNCTION AERemoveSpecialHandler(functionClass: AEKeyword;
  583.                                 handler: ProcPtr;
  584.                                 isSysHandler: BOOLEAN): OSErr;
  585.  INLINE $303C, $0501, $A816;
  586.  
  587. {  Get the special handler named by the Keyword  }
  588. FUNCTION AEGetSpecialHandler(functionClass: AEKeyword;
  589.                              VAR handler: ProcPtr;
  590.                              isSysHandler: BOOLEAN): OSErr;
  591.  INLINE $303C, $052D, $A816;
  592.  
  593.  
  594. {$ENDC} { UsingAppleEvents }
  595.  
  596. {$IFC NOT UsingIncludes}
  597.  END.
  598. {$ENDC}
  599.  
  600.